home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / Updater⁄Infos / OtherMenu 1.7 -> 1.7.1 / Externals Manual next >
Text File  |  1995-02-03  |  14KB  |  221 lines

  1.  
  2.  
  3. -
  4.  
  5.   OtherMenu Externals Manual
  6.   by James W. Walker
  7.   CIS: 76367,2271
  8.   AOL: JWWalker
  9.  
  10.   **Updated February 3, 1995**
  11.  
  12. Each of the standard OtherMenu externals is documented below, with its current version number.  Remember that if you select an external from the menu with the shift key held down, then you will get a dialog box which shows the version and may allow you to change some settings.
  13.  
  14.  
  15.  
  16.  
  17. There are three icons for OtherMenu externals, corresponding to their form, all pictured above (if you are reading this document in TeachText, SimpleText, or Tex-Edit).  See the OtherMenu Manual for how to get information on writing your own externals if you are a programmer.  All three types become menu items in OtherMenu, and, for the most part, we will ignore their differences here.
  18.  
  19.  
  20. Clip Info 1.1
  21. -------------
  22.  
  23. This external provides a submenu listing the types of data on the system clipboard, and how much memory they take up.  If there is text on the clipboard, the submenu also gives a word count and line count.  For example, if you copy some styled text to the clipboard, you might see something like:
  24.  
  25. TEXT: 175 bytes
  26. styl: 22 bytes
  27. ----------------
  28. Lines: 4
  29. Words: 21
  30.  
  31. For the purpose of this count, a “word” is defined to be any string of characters other than space, option-space, return, or tab.
  32.  
  33. Some applications have private clipboards, which may have different contents from the system clipboard.  Switching from one application to another should bring the clipboards into sync.
  34.  
  35.  
  36. Copy File…  1.2.5
  37. -----------------
  38. First you choose a file, then you can save it elsewhere, with another name if you like.  The bottom of the save dialog shows the size of the file and the amount of free space on the disk.  A copy in progress can be cancelled by typing command-period or escape.
  39.  
  40. If you save over an existing file, you will see an alert asking you to confirm the action and letting you know how the modification dates compare.  Specifically, if the file you are saving is newer than the existing file, the alert will say “Replace older <filename>?”, and if the file you are saving is older (a less likely situation) the alert will say “Replace NEWER <filename>?”.  If the dates are the same, the alert will be the familiar “Replace existing <filename>?”.  File replacements will be done by a fail-safe method, so long as there is enough disk space to do so.  That is, the copy will be created in a temporary location, and only when it is complete will the old copy be deleted and replaced by the copy.
  41.  
  42.  
  43. Date/Time 1.3.1
  44. ---------------
  45. Displays a submenu showing the date and the time in several formats.  Selecting one pastes it into the current document.  You can specify a prefix or suffix, e.g. you might want to append “ CDT” after the time.
  46.  
  47. The formats available are affected by Apple’s _Date_&_Time_ control panel.
  48.  
  49.  
  50. Delete... 1.2.1
  51. ---------------
  52. Delete a file or empty folder.  If you want to delete a folder full of files, you can use “Move to Trash” and “Empty Trash” instead.  Normally, you will see an alert saying something like “Are you sure you want to delete <filename>?”.  You can turn off this confirmation, using the configuration dialog, but be careful; deleting a file cannot be undone.  You can also control whether or not locked files should be deleted anyway.
  53.  
  54.  
  55. Desktop Info... 1.3.4
  56. ---------------------
  57. Utility for poking around in the desktop database.  This may not be useful for anyone but programmers.  It shows what icons and sizes are associated with a given creator code.  You may sometimes see the word “paul” in place of an icon; this item stores information related to drag-and-drop.
  58.  
  59.  
  60. Empty Trash 1.0.2
  61. -----------------
  62. Like selecting “Empty Trash” in the Finder, except that you don’t get a dialog asking if you’re sure.
  63.  
  64.  
  65. File Info... 1.3.2
  66. ------------------
  67. Get some information about a file such as data and size, and show or change attributes such as type and creator.  In the case of applications, it can alter the memory partition size.
  68.  
  69. If a file is locked, then an application cannot open it for write access without first unlocking it.  The name locked attribute prevents one from using the Finder to rename the file or give it a custom icon.  The invisible attribute makes the file invisible to the Finder, but not necessarily to directory dialogs like the File Info dialog.  The has BNDL attribute, sometimes called the “bundle bit”, indicates a file that owns an icon family; usually applications, control panels, and extensions have this attribute, and ordinary documents do not.
  70.  
  71.  
  72. Finder Folders 1.0
  73. ------------------
  74. This external is unlike any of my other externals, in that it creates a submenu that itself has submenus.  It lists the folders that are open on the Finder desktop.  This requires a scriptable Finder, as in System 7.5.
  75.  
  76. I think of this external as an “active alias”.  It shows the contents of a “Finder Folders” folder that it creates in your Preferences folder, which is kept up to date by OtherMenu and OtherMenu AE Helper.
  77.  
  78.  
  79. Hard to Soft Wrap 1.3.1
  80. -----------------------
  81. Edits text on the clipboard by replacing any isolated carriage return with a space.  Multiple carriage returns are left alone. A carriage return at the very beginning or end is deleted. Since this does not do anything immediately visible, it plays a sound when it completes successfully.
  82.  
  83. This is not a true external, but a special little application.  I made it an application to fix some clipboard conversion problems.  Since it is an application, you cannot invoke it while a modal dialog is on screen, unlike normal externals.
  84.  
  85. The application is actually a shell containing a Clipboard Magician conversion resource (CNVT and CNV!).  If you have Clipboard Magician, you could duplicate the shell and use the Magic Wand Utility to move a different conversion resource into it.  
  86.  
  87.  
  88. Make Alias As... 1.3.4
  89. ----------------------
  90. Make an alias for a file, folder, or volume, and put it where you like.  This is very useful for setting up your OtherMenu Folder.
  91.  
  92.  
  93. Memory Map 1.4.3
  94. ----------------
  95. Find out how much memory each application is using, and how much is left.  When you don’t have enough free memory to launch another application, this will help you understand why, and let you see which applications you could quit to make room for a new one.  You can also select applications and tell them to quit.
  96.  
  97. When you quit applications, they will usually quit within a few seconds, and the list will update to show the new free memory.  However, if you quit the foreground application, or an application that does not understand AppleEvents, then it may not quit until after you close the Memory Info window.  Also be aware that an application that has unsaved data will probably want to ask you whether to save it before it quits.
  98.  
  99. Optionally, the map displays locked blocks of temporary memory as well as applications.  There are many small ones (less than 1K) associated with launching any application, so I would suggest not displaying the small ones to avoid cluttering the list.  Only a few applications create larger blocks of temporary memory.
  100.  
  101. Clicking the “Settings” button brings up the settings dialog, so that you can more easily change the temporary memory setting.
  102.  
  103.  
  104. Monitor Depth 1.1
  105. -----------------
  106. Set the color depth of the monitor, using a submenu.  If there is more than one monitor, it controls the one with the greatest depth.  If two have the same depth, I'm not sure what happens.  Obviously, if your Mac does not support color or gray-scale, you can trash this.
  107.  
  108. Changes in depth made by this external are forgotten when you restart your Mac, unlike the Monitors control panel.
  109.  
  110.  
  111. Move to Trash... 2.0.3
  112. ----------------------
  113. Move selected files or folders to the trash.  The Add button moves a selected item from the main list to the lower list of items to be trashed, and the Done button tells the Finder to trash the selected items.
  114.  
  115.  
  116. Move/Rename... 1.2.2
  117. --------------------
  118. Move or rename something.  One can only move something within a volume, as in Finder.
  119.  
  120.  
  121. New Folder... 2.0
  122. -----------------
  123. Since some Save dialogs do not have a New Folder button, this external does pretty much the same thing:  It shows a secondary dialog in which you can type the name of a new subfolder, and when you click OK, the Save dialog is ready to save a file in the new folder.
  124.  
  125.  
  126. Open... 1.1.3
  127. -------------
  128. Selecting something (file or folder) with this is rather like selecting it in Finder and then selecting Open from the Finder menu.  In some cases, especially when Finder is not running, this may be able to launch something when OtherMenu itself cannot.
  129.  
  130.  
  131. Paste Clip 1.0
  132. --------------
  133. Using its settings dialog, you can specify a frequently-used piece of text, such as an address (no more than 255 characters.)  When the external is invoked normally, it pastes this text into the current application.  Since the return character can be entered as part of the text, there is no default button, and you must use the mouse to click OK.
  134.  
  135.  
  136. Paste Clips 1.2
  137. ---------------
  138. Stores several frequently-used scraps of text, and displays a submenu so that you can select one to be pasted into a document.  You give each clipping a short label, which identifies it in the menu.  The configuration dialog lets you add, delete, modify, or reorder the clippings.  The New and Delete buttons should be fairly obvious, but you might not guess that you can rearrange the list by dragging a cell of the list and dropping it in a different position.
  139.  
  140. The label can be up to 20 characters long, and the clipping can be up to 1024 characters long.  If the label begins with a hyphen, the item will appear as a dividing line in the menu.
  141.  
  142.  
  143. Put Away... 1.3
  144. ---------------
  145. Put items in the trash or on the desktop back where they came from.  Also unmounts disks.  The Finder needs to be running to do a normal “put away”, but not to unmount a disk.
  146.  
  147. You can shift-click to make contiguous multiple selections, or command-click to make arbitrary multiple selections.  A double click on a list acts as a shortcut for a click on a list followed by a click on the OK button.
  148.  
  149. One of the two lists has an extra frame, indicating that it is the target of keyboard commands.  You can select an item using the up and down arrow keys, or by typing a few letters of a name.  You can scroll the list using the page up, page down, home, and end keys if your keyboard has those keys.  The tab key switches to the other list.
  150.  
  151.  
  152. QuickAlias 1.0.2
  153. ----------------
  154.  
  155. This external may be more convenient than “Make Alias As” if you will be making many aliases in the same place, as when you are setting up your Other menu or your Apple menu.  When you run this external, it displays a dialog showing a path to a folder.  If it is not the folder in which you want to create some aliases, click the “Set Folder” button and select a new folder.  As long as QuickAlias is running, any item that you select from the Other menu will be aliased into the chosen folder.  When an alias is created, a little sound is played to reassure you that something happened.
  156.  
  157. You might find it convenient to make several copies of QuickAlias, set to different folders.
  158.  
  159.  
  160. QuickTrash 1.0.1
  161. ----------------
  162.  
  163. This external can be used as an alternative to “Move to Trash” for trashing multiple items.  When the external is running, any item you select from the Other menu will be moved to the trash.  If you select an alias, then the alias will be moved rather than the original item, just as in the Finder.  When an item is trashed, a little sound is played to reassure you that something happened.
  164.  
  165. If you try to trash something when the trash already contains an item of the same name, QuickTrash may ask Finder for help.  So in this case if Finder is not running, it will not work, and if QuickTrash is running within Finder, then the action will not be completed until you dismiss QuickTrash.
  166.  
  167.  
  168. Quit Finder 1.2.1
  169. -----------------
  170. Tells the Finder to quit.  If file sharing is turned on, it will be turned off just before Finder.
  171.  
  172. Actually, you can use this to make any other single application quit, by using its configuration dialog to specify the creator code of an application.  But you’d only do that for something you quit very often, since Memory Map would otherwise be a more convenient way to quit something.
  173.  
  174.  
  175. Quote 1.0
  176. ---------
  177.  
  178. This external transforms text on the clipboard for BBS quoting.  The way you would use it is to copy some text to the clipboard, invoke the Quote external, and then paste, perhaps into a different application.  If you invoke Quote with the option key held down, you will be able to set various options:  Whether to break lines so that they are not too long, a prefix string to be added to the beginning of each line, and whether to replace curly quotes by straight quotes.
  179.  
  180. You might want to make several copies of Quote, with different settings.  If you turn on “Rewrap lines”, set the maximum line length to 0, and set the prefix string to the empty string, then Quote behaves almost exactly like Hard to Soft Wrap.  On the other hand, by specifying a positive maximum line length you can use Quote to hard-wrap text.
  181.  
  182.  
  183. Restart 1.0.2
  184. -------------
  185. Like the Restart command in Finder.  In fact it works by telling Finder to do a restart.
  186.  
  187.  
  188. Shut Down 1.0.1
  189. ---------------
  190. Like the Shut Down command in Finder.  In fact it works by telling Finder to do a shutdown.
  191.  
  192.  
  193. Sleep 1.0
  194. ---------
  195. Like selecting Sleep in the Finder.  Of course this only works on those models that have a sleep mode.  Finder must be running, but need not be in the foreground.
  196.  
  197.  
  198. Speaker Volume 1.1.1
  199. --------------------
  200. Provides a submenu for setting the speaker volume.
  201.  
  202.  
  203. Stuff 1.0
  204. ---------
  205. If you have Aladdin’s StuffIt Engine installed, you can use this to select a set of files or folders, to be stuffed into a new archive.
  206.  
  207.  
  208. Unstuff 1.0
  209. -----------
  210. If you have Aladdin’s StuffIt Engine installed, you can use this to decode anything that the StuffIt Engine can decode.  For instance unstuff StuffIt archives, decompress Compact Pro archives, and decode binhex files.
  211.  
  212.  
  213. Volume Info 1.2.5
  214. -----------------
  215. Shows the icon, name, free space, and number of files on each mounted volume.
  216.  
  217.  
  218. Windows 2.0
  219. -----------
  220. Provides a submenu of windows in the current application.  Selecting one brings it to the front, not counting floating windows, unless the front window is a modal dialog.
  221.